home *** CD-ROM | disk | FTP | other *** search
/ Workbench Designer 2 / Workbench Designer 2.iso / workbench-tools / amigaeye / amigaeye.doc < prev    next >
Encoding:
Text File  |  1997-06-28  |  15.7 KB  |  288 lines
  1.                                              _   _
  2.                                             / \ / \
  3.                                             \#/ \#/
  4.            _              _                    _      _             _
  5.           /(\  Version:  /(\     _            /(\    /(\           /(\
  6.          /  \    37.5   /  \    /(\          /  \   /  \          /  \
  7.         /    \   39.5  /    \  /  \         /    \ /    \___     /    \
  8.        /      \       /      \/    \       /     //     ___ \   /      \
  9.       /        \     /              \     /     //     /\__\ \ /        \
  10.      /          \   /                \   /     //     / /   )//          \
  11.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  12.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  13.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  14.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \___\     \
  15.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  16.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  17.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  18.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  19.                                                            _______  ___ _____
  20.       Christian Krapp       krabbe@rz.fh-augsburg.de      / __//\ \/ /// __//
  21.       Hagenmähderstr.9                                   / _//   \  /// _//
  22.     D-86391 Stadtbergen                                 / //__   / /// //__
  23.       (GERMANY)                                         \___//  /_// \___//
  24.                                              © 1995,1996,1997 by Christian Krapp
  25.                                                     Released as SHAREWARE
  26.  http://www.fh-augsburg.de/~krabbe/amigaeye/
  27.  
  28.              An AugustA team Release!
  29. --------------------------------------------------------------------------------
  30.  
  31. Copyright:
  32.   This program and all accompanying files (program-icon) are copyrighted 1995-97
  33. by Christian 'cr8y' Krapp! You can  copy these  files to your friends as long as
  34. the files are unchanged. It is not allowed to demand a fee higher as media costs
  35. and a (little) copy-fee. In addition, no one is allowed to put these  files onto
  36. a PD-disk or an CD-Rom. You can get a permittion by the author. Please contact!
  37.  
  38. For the AmiNet, FreshFish and MeetingPearls CD-Rom's is no permittion requiered!
  39.  
  40.   This  program is Shareware. Everyone, who use this program, should register it
  41. by  sending me  the registration  fee (see below). The shareware  fee is  5,- DM
  42. plus postage. 
  43.  
  44.   When you use this little program, than you use it on your own risk! The author
  45. take no respons for damage made by AmigaEYE!
  46.  
  47. --------------------------------------------------------------------------------
  48.  
  49. What is it?
  50.   Do you know these funny Eye-programs, which follow the mouse-pointer! Ok. Than
  51. you know AmigaEYE. It's an Eye-program for an upstyled Workbench.
  52.   The first lines of code are written back in 1995 and were released as MagicEYE
  53. Since that first work are 2 years  gone by and so the program changed a lot (not
  54. only the Name and the shareware fee). Look at the history at the end ;-)
  55.  
  56. --------------------------------------------------------------------------------
  57.  
  58. 10 reasons, why to use this program:
  59.  
  60.  1.) colorized eyes ;^)
  61.  2.) automatic window close, when WB is closed (screennotify.library)
  62.  3.) you can configurate a lot
  63.  4.) patch to have an screen-drag AmigaEYE-window
  64.  5.) 10(!) different eye-effects
  65.  6.) colorremapping, MagicWB nolonger needed (AmigaOS 3.0+)
  66.  7.) very short program
  67.  8.) it's an commodity
  68.  9.) can copy screen-background into AmigaEYE-window
  69. 10.) AmigaEYE-window is the hindmost window
  70.  
  71. --------------------------------------------------------------------------------
  72.  
  73. What do you need?
  74.   You need  of course an  Amiga-Computer  (or an compatible  one ;^) ). Also you
  75. need  at least AmigaOS 2.04  or  higher. Sorry, but  I can't guarantee, that the
  76. version for  AmigaOS 2.04 work, because I  have only an  Amiga with AmigaOS 3.0.
  77. In  addition to the OS you  should run your Workbench with at least 8 colors and
  78. a quadratic resolution (e.g.  640×512).  Last  but  not least you should  use an
  79. 13 point  high font  for screen title.  This is necassery,  because AmigaEYE has
  80. an fixed high of  13 points.  And new for  release 2 of  AmigaEYE  you  need the
  81. screennotify-library from  Stefan Becker (optional, if you want automatic  close
  82. of the AmigaEYE-Window when WB close).
  83.  
  84. --------------------------------------------------------------------------------
  85.  
  86. Different program versions:
  87.   It's very simple:  The 'new' AmigaOS 3.0  has some  better functions which are
  88. supported by AmigaEYE. And so, I have produced two versions: One for AmigaOS 2.0
  89. (AmigaEYE_37) and one for AmigaOS 3.0 (AmigaEYE_39) and higher.
  90.  
  91. --------------------------------------------------------------------------------
  92.  
  93. How to install?
  94.   Nothing simpler than that: you copy only the right program-version of AmigaEYE
  95. to your WBStartup-directory on you startvolume (disk, hd...). That's it :-]
  96.   When you  want  to  run  your  User-Startup,  than  copy  AmigaEYE  into  your
  97. C-Directory and run AmigaEYE from User-Startup.
  98.  
  99. --------------------------------------------------------------------------------
  100.  
  101. How to use?
  102.   You can run this program from the Workbench (or the WBStartup directory) and
  103. from a Shell (User-Startup).
  104.  
  105.   DONOTWAIT       : This has nothing  to do with  AmigaEYE. It's only a flag for
  106.                     Workbench.
  107.   WIN_X           : Where  do you want to place  the AmigaEYE-window?  Here  you
  108.   WIN_Y             configurate  the x and y  position.  Default:  WIN_X=545 and
  109.                     WIN_Y=1
  110.                     ATTENTION: If  you use  an  titlefont smaller than 13 point,
  111.                     set the value of WIN_Y to 0.
  112.   PRIORITY        : Defines the task-priority.  This value should  be lower than
  113.                     0, so, other programs (which need the system-time) gets more
  114.                     system-time. The default value is 0 (program) or -5 (Icon).
  115.   MOVEABLE        : Window can be moved on the screen.
  116.   DRAGPATCH       : With  this (non system-friendly)  patch it  is possible,  to
  117.                     drag the  screen  with the  AmigaEYE-window.  So there is no
  118.                     different on  the screen-title,  when  you want to drag down
  119.                     the screen (funny). Default is off!
  120.   BACKGROUND      : Copy the background of the  position, where the Eyes appears
  121.                     into the AmigaEYE window (and so into the background).
  122.   QUICKQUIT       : Enable faster quitting of AmigaEYE (with right Mousebutton).
  123.   BACKDROP        : Enable the Layer  Patch,  that bring the  AmigaEYE window to
  124.                     the  hindmost  window  (every time!).  ATTENTION: with  this
  125.                     patch there will be the function BehindeLayer (-54) from the
  126.                     layer.library changed!
  127.   SLEEP_PERIOD    : This  flag define  the time (in sec)  that the program wait,
  128.                     till it close the Eyes, when the mouse isn't moved!
  129.                     Default: 5. (Try different values!)
  130.   LIDCOLOR1       : With these ToolTypes you can change the color of the graphic
  131.   LIDCOLOR2         After the keyword you must give an hex-number:
  132.   BLOODCOLOR                                  RRGGBB
  133.   PUPILCOLOR1          RR - red (00 - FF)
  134.   PUPILCOLOR2          GG - green (00 - FF)
  135.   PUPILCOLOR3          BB - blue (00 - FF)
  136.   EYECOLOR1         
  137.   EYECOLOR2         So FFFFFF means the color white!
  138.   PUPILREDCOLOR1    ATTENTION: When  the new color-values  aren't used,  then it
  139.   PUPILREDCOLOR2               can  be, that  there  are no  free  colors on the
  140.   PUPILREDCOLOR3               screen.
  141.  
  142. And now the effect-configuration. Very  important to know: The values,  that you
  143. give here, are interpreted as a probability (1/value). The value must be greater
  144. than 1, an value of 0 means, that this effect isn't activ:
  145.  
  146.   SLEEPY            : This  value is  needed, to  define how often the  Eyes are
  147.                       closed. 
  148.   TIRED             : Define, how often the eye-lid's go down to the half.
  149.   ROLL_SYNCHRON     : When roll the Eye synchron (in same direction).
  150.   ROLL_ASYNCHRON    : When roll the Eye asynchron (in different direction).
  151.   LEFTRIGHT         : How often the Eye's look Left-Right.
  152.   UPDOWN            : How often the Eye's look Up-Down.
  153.   RANDOM_EYE        : Defines, when you get the trembling Eye's.
  154.   BLOODY            : When get the red Eye's?
  155.   CLEAR             : When should get the red Eye's get cleared?
  156.   LEFT_EYE          : Close left Eye. (depend on SLEEPY)
  157.   RIGHT_EYE         : Close right Eye. (depend on SLEEPY)
  158.   ANGRY             : Angry Eyes. (depend on SLEEPY)
  159.   ANXIOUS           : Anxious Eyes. (depend on SLEEPY)
  160.   INSULT            : Insult Eyes. (pupiles look in other direction)
  161.   STOP_TIRED        : When to stop the TIRED effect.
  162.   STOP_ANGRYANXIOUS : When to stop the angry and anxious eyes.
  163.   STOP_EFFEKT       : When to stop any effect.  If you put here an 0  the effect
  164.                       run endless.
  165.   PUPILNORMAL       : When should normal pupils appear.
  166.   PUPILBIG          : When should big pupils appear.
  167.   PUPILCROSS        : When should cross pupils appear.
  168.   PUPILAMIGA        : When should Amiga pupils appear.
  169.   PUPILHEART        : When should heart pupils appear.
  170.  
  171.   So, that's it.  You know now all the features  of AmigaEYE. Or...? You want to
  172. know, how to exit this mega mighty program? Is it true? Do you want to quit this
  173. program?  Ok. I see... You want  know  this (very stupied :-|) feature: There
  174. are two ways (argh... three ways):
  175. 1.) Run AmigaEYE again!
  176. 2.) Run Exchange, select AmigaEYE and quit it!
  177. 3.) (when QUICKQUIT) Activate AmigaEYE-Window and press right Mousebutton!
  178.  
  179. --------------------------------------------------------------------------------
  180.  
  181. What can be made better?
  182.   * More funny things with the Eyes
  183.   * Eye's with eyebrow's?
  184.   * It is possible, that there exists errors (undocumented features ;^) or bugs)
  185.     which we doesn't want!
  186.  
  187. --------------------------------------------------------------------------------
  188.  
  189. ATTENTION: AmigaEYE is distributed via ADSG! So  registrations should be send to
  190. ADSG (look at extra file). ADSG: http://www.amigaworld.com/adsg/
  191.  
  192. To register AmigaEYE (and bug-reports, new ideas) send a mail to:
  193.  
  194.                  sMail:           Christian Krapp
  195.                                   Hagenmähderstr. 9
  196.                                 D-86391 Stadtbergen
  197.                                   (GERMANY)
  198.                  eMail:           krabbe@rz.fh-augsburg.de        
  199.  
  200.         Shareware fee :           5,- DM
  201.  
  202. --------------------------------------------------------------------------------
  203.  
  204. History:         (xx means 37 (AmigaOS 2.04) or 39 (AmigaOS 3.0+))
  205.         __       __
  206.         )\\     /((                                          __
  207.        /  \\   /  \\               __         ________      / \\     ________
  208.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  209.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  210.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  211.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  212.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  213.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  214. / // © 1995--1997 by \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  215. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  216.       sMail:                                               ________ ___ _____
  217.   Christian Krapp                 eMail:                  / __//\ \V /// __//
  218.   Hagenmähderstr.9    krabbe@informatik.fh-augsburg.de   / _//   \  /// _//
  219. D-86391 Stadtbergen                                     / //__   / /// //__
  220.   (GERMANY)                        WWW:                 \___//  /_// \___//
  221.  
  222. Vxx.0   28.04.1995 - First try (produced MagicEYE-Animation).
  223. Vxx.1   16.06.1995 - After a long work it's done. The first public-version ok.
  224. Vxx.2   01.08.1995 - Silly error removed (Thanks Roland Fulde).
  225.                    - Colorizing implemented  (Markus Speicher and Mario Cattaneo
  226.                      were interessted, only 39.x-Version).
  227.                    - ScreenNotify-Library supported (Mario Cattaneo).
  228.                    - Rolling Eye (Dirk Wrocklage).
  229.                    - Tremble and red Eye's (Michael Krapp).
  230.                    - Rolling  Eye  asynchron,  tired  Eye  and  look  Left-Right
  231.                      (Christian Krapp)
  232. Vxx.3   01.03.1996 - ScreenNotify-Library optional!
  233.                    - supports Commodity-Library 
  234.                    - red Eye's become white after a while of closed Eye's
  235.                    - removed  time-waste  when Eye's are  closed  (problems with
  236.                      Nemac IV)
  237. Vxx.4   20.02.1997 - Trancparent background (optional)!
  238.                    - Quickquit again included!
  239.                    - MagicEYE window is hindmost window
  240.                    - MagicEYE in WWW http://www.fh-augsburg.de/~krabbe/magiceye/
  241.                                              _   _
  242.                                             / \ / \
  243.                                             \#/ \#/
  244.            _              _                    _      _             _
  245.           /(\         :  /(\     _            /(\    /(\           /(\
  246.          /  \           /  \    /(\          /  \   /  \          /  \
  247.         /    \         /    \  /  \         /    \ /    \___     /    \
  248.        /      \       /      \/    \       /     //     ___ \   /      \
  249.       /        \     /              \     /     //     /\__\ \ /        \
  250.      /          \   /                \   /     //     / /   )//          \
  251.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  252.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  253.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  254.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \_  \     \
  255.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  256.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  257.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  258.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  259.                                                            _______  ___ _____
  260.       Christian Krapp       krabbe@                       / __//\ \/ /// __//
  261.       Hagenmähderstr.9      informatik.fh-augsburg.de    / _//   \  /// _//
  262.     D-86391 Stadtbergen                                 / //__   / /// //__
  263.       (GERMANY)                                         \___//  /_// \___//
  264.                                              © 1995,1996,1997 by Christian Krapp
  265.                                                   Freigegeben als SHAREWARE
  266.  
  267. Vxx.5  01.07.1997  - Bug in Layer-Patch removed
  268.                    - Needs less cpu-time!
  269.                    - You can change the color of the eyelid, bloody eyes, pupils
  270.                      and eyes.
  271.                    - New effects:
  272.                      + eyelid can close independent form other lid,
  273.                      + angry, anxious and insult eyes,
  274.                      + Pupil look up and down.
  275.                      + different pupil-graphics:
  276.                        * normal
  277.                        * big pupil
  278.                        * cross pupil
  279.                        * amiga pupil
  280.                        * heart pupll
  281.                    - Disable the single effects.
  282.                    - Window can be moved
  283.                    - Needed ToolTypes implemented.
  284.                    - Additional configuration-file.
  285.                    - Removed a lot of bugs.
  286.  
  287. --------------------------------------------------------------------------------
  288.